DSMConsole.ini 設定リファレンス
この文書はDSMConsole.iniで設定できる項目と動作を整理した資料だ。
ファイルの位置と適用方法
- 基本位置:
GetModulePath() + "DSMConsole.ini"、つまりDSMConsole.exeと同じディレクトリ - 書き込み項目:
[INIT]のUSERID,ADDRESS,PORT万コンソール終了/プロファイル保存時に更新されます。 - 残りの項目は読み取り専用です。
- 文字列の比較は別途言及がない限り、大文字と小文字を区別します。
迅速な例
[INIT]
LANG=KOR
TIMEOUT=60
RECVTIMEOUT=120
ADDRESS=127.0.0.1
USERID=document
PORT=62004
CONNECTION=SSL
TEXTBUTTON=NO
BUTTONSIZE=16
CORPLOGO=YES
PASSWDHASH=HASH
; 세미콜론으로 구분한 허용 접두어
CUSTOMID_FILTER_PREFIX=CUSTOM_;IPDS_
ADDINID_FILTER_PREFIX=ADDIN_;SWORK_
; 값 의 첫 글자가 1일 때 활성화
SWORK_SEMI_FREE_ENABLE=1
SWORK_NORMAL_ENABLE=1
SWORK_MAXEON_ENABLE=1
SWORK_HIDE_HOOK_MODULE=0
SWORK_HIDE_COND_MODULE=0
SWORK_HIDE_DETECT_POLICY=0
SWORK_HIDE_EXCEPT_POLICY=0
SWORK_HIDE_HOOK_EXT_MSG=0
SWORK_HIDE_HOOK_FORMAT_VIEW=0
MAX_DEC_COUNT_DAY=9999
MAX_DEC_COUNT_PER=9999
MARKING_EX_SPAN=30
LOGINIPCOUNT=1
NTSIP=127.0.0.1
NTSPORT=62000
[PWD]
ENABLE=NO
[RES]
RES_STRING=0
WRITE_FILE_NAME=ConsoleResource.ini
[ORG_EXECUTE0]
TITLE=도구 실행
EXE=C:\Tools\Tool.exe
PARAM=
例は形式説明用である。サーバーアドレス、ポート、ポリシープレフィックス、実行ファイルは運用環境に応じて指定する必要がある。
[INIT]基本動作
| キー | 値/形式 | 鍵がないとき | 動作 | アクセス |
|---|---|---|---|---|
LANG | ENG, JPN, その他 | 日本語 | ENGは英語、JPN日本語リソースをロードします。それ以外の値と空の値は韓国語です。KOR)で処理する。 | 読み取り |
TIMEOUT | 整数（秒） | 60 | 通信制限時間を設定します。別途範囲制限はありません。 | 読み取り |
RECVTIMEOUT | 整数（秒） | 120 | 値が正の数であれば最大300秒数を制限して受信制限時間を設定します。0以下は既存の値を変更しません。 | 読み取り |
ADDRESS | サーバー IP/ホスト文字列 | 空の文字列 | 既存のログインアドレスと異なり、値が127.0.0.1この条件が成り立つ場合、INIのサーバーアドレスで上書きされます。USERID, PORTと一緒に読む。 | 読み/書き |
USERID | 管理者 ID 文字列 | 空の文字列 | ADDRESSが上書き条件を満たす場合、管理者IDとして使用します。保存時に現在の管理者IDを記録します。 | 読み/書き |
PORT | 整数 | 既存の設定値を維持 | ADDRESSが上書き条件を満たし、キーの読み取りに成功した場合、サーバ ーポートを変更します。保存時に現在のポートを記録します。一般的な基本ポートは62004はい。 | 読み/書き |
CONNECTION | SSLまたはその他 | TCP | 正確にSSLSSLの時、それ以外の値と空の値はTCPを使用します。 | 読み取り |
TEXTBUTTON | YESまたはその他 | NOと同じ | 正確にYESツールバーをテキストボタンモードに設定します。 | 読み取り |
BUTTONSIZE | 整数 | 16 | 開始時にボタンのサイズとして使用します。別途範囲制限はありません。 | 読み取り |
CORPLOGO | YESまたはその他 | 以下の注意を参照してください | 正確にYES会社のロゴを表示する。 | 読み取り |
VERSION | 文字列 | 空の文字列 | 表示用コンソールバージョン文字列として使用する。 | 読み取り |
VERSION_SERVER | 文字列 | 空の文字列 | 表示用サーバーバージョン文字列として使用する。 | 読み取り |
CONSOLEVERSION | 文字列 | 空の文字列 | 内部コンソールバージョン文字列として使用します。 | 読み取り |
PASSWDHASH | PLAINまたはその他 | ハッシュの使用 | パスワードハッシュ機能が有効な環境で正確にPLAINイモン平文モード、それ以外の値やキーがない場合はハッシュモードだ。 | 読み取り |
ログインアドレスの上書き注意
ADDRESSの基本文字列は明示的に127.0.0.1これは空の文字列ではない。キーがなく、レジストリアドレスが空の文字列と異なる場合、条件上空のアドレスで上書きできるため、ログインサーバーをINIで管理する際はADDRESS, USERID, PORTを一緒に指定することが安全です。
CORPLOGO欠落時の実効値に注意
CORPLOGOキーがない場合はTEXTBUTTON値の影響を受けて次のように動作する。
TEXTBUTTON=YESであるCORPLOGOなし: ロゴ表示- それ以外または
TEXTBUTTONなし: ロゴ非表示
意図した状態を保証するにはCORPLOGO=YESまたはCORPLOGO=NOを明示する必要がある。
[INIT]政策およびUI設定
| キー | 値/形式 | 鍵がないとき | 動作 |
|---|---|---|---|
CUSTOMID_FILTER_PREFIX | セミコロン(;) 区分接頭語一覧 | フィルター未適用 | ポリシー ID がリストの接頭辞のいずれかで始まるカスタムポリシーのみを残します。空のトークンでパースが終了します。 |
ADDINID_FILTER_PREFIX | セミコロン(;) 区分接頭語一覧 | 全体表示 | ファイル名がリストの接頭辞のいずれかで始まるイベントハンドラー/アドインのみを残します。 |
SWORK_SEMI_FREE_ENABLE | 最初の文字1 | 非アクティブ | プロセス追加画面でSemi-Freeプロセスタイプを表示します。 |
SWORK_NORMAL_ENABLE | 最初の文字1 | 非アクティブ | プロセス追加画面で一般プロセスタイプを表示します。 |
SWORK_MAXEON_ENABLE | 最初の文字1 | 非アクティブ | プロセス追加画面でMAXEONプロセスタイプを表示します。 |
SWORK_HIDE_HOOK_MODULE | 最初の文字1隠す | 編集 UIは表示 | プロセス追加画面のHookモジュール領域を隠し、ウィンドウを縮小します。プログラム詳細ツリーではキーが存在し、値が1Hookノードはこれでない場合にのみ表示されます。 |
SWORK_HIDE_COND_MODULE | 最初の文字1編集 UI 非表示 | 編集 UIは表示 | 制御条件の含まれるモジュール入力コントロールと案内文を隠す。ただし、詳細ツリーコードは値が1名前と反対の表示動作が共に存在するため、__PH_0__の時に含まれるモジュール情報を追加します。 |
SWORK_HIDE_DETECT_POLICY | 最初の文字1隠す | 詳細ツリーノード未生成 | キーが存在し、値が1この場合にのみ変更検出ポリシーノードを表示します。 |
SWORK_HIDE_EXCEPT_POLICY | 最初の文字1隠す | 詳細ツリーノード未生成 | キーが存在し、値が1この場合のみ例外ポリシーノードを表示する。 |
SWORK_HIDE_HOOK_EXT_MSG | 最初の文字1隠す | 表示 | 拡張子設定画面のメッセージ表示チェックボックスを隠す。 |
SWORK_HIDE_HOOK_FORMAT_VIEW | 最初の文字1隠す | 表示 | 拡張子設定画面のフォーマット表示ボタンを隠す。 |
MAX_DEC_COUNT_DAY | 整数 | 9999 | 日別復号化制限入力コントロールの最大値として使用される。最小値は0です。 |
MAX_DEC_COUNT_PER | 整数 | 9999 | 1回/個別復号制限入力コントロールの最大値として使用する。最小値は0です。 |
MARKING_EX_SPAN | 整数(1) | 30 | マーク例外期間をオンにすると、終了日を現在の日付から指定日数だけ前にリセットします。 |
LOGINIPCOUNT | 整数 | 1 | 管理者許可IPリストに追加できる最大数です。現在のリストのサイズが値以上の場合、追加動作を中止します。 |
NTSIP | IP/ホスト文字列 | 空の文字列 | リアルタイムポリシー適用時のNTSソケット接続対象アドレスです。 |
NTSPORT | 整数 | -1 | リアルタイムポリシー適用時のNTSソケット接続対象ポートです。 |
SWORK 詳細ツリーキーの欠落と0違い
SWORK_HIDE_HOOK_MODULE, SWORK_HIDE_DETECT_POLICY, SWORK_HIDE_EXCEPT_POLICYの詳細ツリーコードはGetPrivateProfileString()この成功したブロックの中でのみノードを作成します。したがって、次の違いがあります。
- キーがありません: 該当の詳細ツリーノードを作成しません
- 値
1: 該当の詳細ツリーノードを作成しません - 値
0また最初の文字が1この値ではない: 該当する詳細ツリーノードを表示
ノードを表示するにはキーを省略しないでください0として明示する必要がある。
[PWD]
| キー | 値/形式 | 鍵がないとき | 動作 |
|---|---|---|---|
ENABLE | YESまたはその他 | 非アクティブ | CSOでパスワード初期化ボタンの表示が許可されている場合、正確にYESユーザーのパスワード入力コントロールの無効状態を解除します。 |
[KEY]
| キー | 値/形式 | 鍵がないとき | 動作 |
|---|---|---|---|
DSHEAD | 正確に16文字の文字列 | サーバープロファイルのDDT_DSHEADERKEY使用 | 感謝トレースファイル処理用サーバー DS ヘッダーキーを上書きします。INI 値も最終的な長さが正確に 16 文字の時のみ適用されます。 |
DSHEADは暗号化ファイル処理に影響を与える敏感なキーです。誤った値は復号化の失敗を引き起こす可能性があり、文書や構成管理に運用キーを記録してはいけません。
[RES]リソースの抽出/適用
RES_STRINGはCCsPropertyPage, CSiteDialog, SCInfoView初期化時に共通して評価される。
| キー | 値/形式 | デフォルト値 | 動作 |
|---|---|---|---|
RES_STRING | 0, 1, 2 | 0 | 0: 何の作業も行いません。1: 現在ウィンドウのコントロール文字列をファイルに抽出。2: ファイルの文字列を現在のウィンドウコントロールに適用。 |
WRITE_FILE_NAME | ファイル名またはパス文字列 | 空の文字列 | RES_STRING=1モジュールパスを基準に抽出ファイルパスを設定します。 空の値の場合、言語マネージャーに初期化されたデフォルトパスが保持されます。ファイルがない場合は、UTF-16 BOMファイルを作成します。 |
[ORG_EXECUTE0] ~ [ORG_EXECUTE5]
組織/グループツリーのコンテキストメニューに外部プログラムを最大6つ登録する。インデックス範囲は0から5まである。
| キー | 必須 | 動作 |
|---|---|---|
TITLE | はい | メニューに表示するタイトルです。空の値の場合は、その項目をスキップします。 |
EXE | はい | 実行ファイルのパスです。空の値であるか、ファイルが実際に存在しない場合は、該当項目をスキップします。 |
PARAM | いいえ | 実行プログラムに渡すパラメータ文字列です。空の値も許可されています。 |
有効な最初の項目を見つけたら、上位実行メニューを作成し、各項目をID_POPUP_MEMBER_EXECUTE_PROGRAM + 인덱스コマンドで追加する (DSOrgGroupView_GroupTreePartial.cpp:1100-1111).
ソースから除外した項目
次は名前のせいでDSMConsole.ini設定とし て誤解しやすいが、実際の保存場所は異なる。
| 項目 | 実際のリポジトリ |
|---|---|
[LOGIN]のUSERID, ADDRESS, PORT, TIME, 動的管理者キー | SetRegistryKey("DSConsole3xU")指定したWindowsレジストリ。ただし、USERID/ADDRESS/PORTは別途[INIT]にも保存される。 |
[SIZE]ウィンドウの位置/状態 | Windows レジストリ |
[CONNECTION] DB ID, PW, DS | Windows レジストリ |
[AKSSERVER]のIP, PORT | Windows レジストリ |
DSMailAuth.iniの[MAIL_AUTH] | 別のファイルDSMailAuth.ini |
console.cso, console.csmオプション | 別途 CSO/CSM ファイル |
DSSerial/SerialFunc.cppのDSMConsole.iniコピー参照の2つの場所はすべてコメントアウトされており、現在の実行コードには含まれていない。
変更時の点検事項
YES,PLAIN,SSL,ENG,JPNはソースの正確な文字列と大文字と小文字を合わせる。SWORK_*フラグは文字列の最初の文字だけ1認知検査を行う。- フィルター接頭辞のリストは
;で区切り、リストの途中に空のトーク ンを入れない。 ADDRESS,USERID,PORTはログイン時に相互連携されるため、一緒に設定します。CORPLOGO詳細ツリー表示フラグはキーの欠落の動作が直感的でないため、値を明示します。DSHEAD同じ秘密値と実際のDB/管理者資格情報は構成管理にコミットしない。